
=============================================================================
Run Date: OCT 11, 2017                     Designation: IVM*2*167
Package : IVM - INCOME VERIFICATION MATCH     Priority: Mandatory
Version : 2                                     Status: Under Development
=============================================================================

Associated patches: (v)IVM*2*159   <<= must be installed BEFORE `IVM*2*167'
                    (v)IVM*2*165   <<= must be installed BEFORE `IVM*2*167'

Subject: ENROLLMENT SYSTEM COMMUNITY CARE (ESCC) HOME PHONE UPDATES 

Category: 
  - Routine

Description:
============

 ********************************DRAFT**********************************
 Patch IVM*2.0*167 is being released to support the enhancements for the  Enterprise Health Benefits 
Determination (EHBD) program that focuses on  updates for the Enrollment System Modernization 
(ESM) project, which  supports Enrollment System Community Care (ESCC).
  
 IVM*2.0*167 is also being released in support of the Enrollment System
 (ES) 4.8.0 release. Refer to Informational Patch EAS*1*xxx (Enrollment  Application System) for 
additional details regarding the ES release.
  
 Because this is a multi-package build, it can only be distributed as a host  file; no builds are included in 
the patch messages. The name of the host file
 is: DG_53_P935.KID; it can be obtained from one of the anonymous Secure File  Transfer Protocol 
(SFTP) directories listed in the 'Software and  Documentation  Retrieval Instructions' section of this 
patch. 
 
 Home Phone Number updates include disabling Home Phone data elements in  Income Verification 
Match (IVM) Demographics Upload Tool and directly  uploading them to PATIENT file (#2).
  
 The Future Discharge Date (FDD) Military Service Episode (MSE) build  components include changes to 
manage and process an FDD MSE (either  manually updated in Enrollment System (ES), received from 
the military  service broker, or received via an on-line Healthcare Application). A  Veteran can apply for 
Department of Veterans Affairs (VA) health benefits  enrollment before being discharged from the 
military. ES is the VA  authoritative system for this information. ES will accept an FDD based on  the 
system date from one to one-hundred eighty days in the future. The FDD  MSE will not be transmitted 
from Veterans Health Information Systems and  Technology Architecture (VistA) to ES.
  
 Patch IVM*2*167 is being released as a supporting patch for  Registration patch DG*5.3*935. It 
contains routine changes to check if an  MSE has an FDD. If an MSE has an FDD, it will not be included in 
the ZMH  segment of the ORU-Z07 and ORF-Z07 messages sent from VistA to ES.
 
 Listing of Updates
 ================== 
  
 1. Disable Home Phone data elements in the IVM Demographics Upload tool  as it will not allow VistA to 
file PHONE NUMBER [RESIDENCE], RESIDENCE  NUMBER CHANGE DT/TM, RESIDENCE NUMBER CHANGE 
SITE or RESIDENCE NUMBER  CHANGE SOURCE when processing HL7 messages from ES.
  
 2. Directly upload the Home Phone data elements PHONE NUMBER [RESIDENCE]  field (#.131), 
RESIDENCE NUMBER CHANGE DT/TM field (#.1321), RESIDENCE  NUMBER CHANGE SITE field (#.1323), 
RESIDENCE NUMBER CHANGE SOURCE field
 (#.1322) into PATIENT file (#2) when received from ES if the conditions  listed below are met:
 
  a. The Change Date/Time of the incoming Home Phone Number is not null
  b. The Change Date/Time of the incoming Home Phone Number from ES is more
     recent than the VistA Change Date/Time of Home Phone Number
  
 3. Update VistA to exclude the FDD MSE in the ZMH segment of the ORU/ORF-Z07.
 
 Patch Components
 ================
  
 Files & Fields Associated:
  
 File Name (Number)         Field Name (Number)     New/Modified/Deleted
 ------------------         -------------------     --------------------
 N/A
  
 Forms Associated:
  
 Form Name                  File #                  New/Modified/Deleted
 ---------                  ------                  --------------------
 N/A
  
 Mail Groups Associated:
  
 Mail Group Name            New/Modified/Deleted
 ---------------            --------------------
 N/A
  
 Options Associated:
  
 Option Name                Type                    New/Modified/Deleted
 -----------                ----                    -------------------- 
 N/A
  
 Protocols Associated:
  
 Protocol Name              New/Modified/Deleted
 -------------              --------------------
 N/A
  
 Security Keys Associated:
  
 Security Key Name
 -----------------
 N/A
  
 Templates Associated:
  
 Template Name      Type    File Name (Number)  New/Modified/Deleted 
 -------------      ----    ------------------  --------------------
 N/A
  
 New Service Requests (NSRs):
 -----------------------------
 N/A
 Patient Safety Issues (PSIs):
 ------------------------------
 N/A
  
 Defect Tracking System Ticket(s) & Overviews:
 -----------------------------
 N/A
  
 Problem:
 --------
  
 Resolution:
 -----------
   
 Test Sites:
 -----------
 TBD 
  
 Software and Documentation Retrieval Instructions:
 ----------------------------------------------------
 Patches for this installation are combined in the following host file for
 distribution: DG_53_P935.KID. 
  
 The host file was created to simplify installation at Veterans  Health Administration (VHA) facilities. This 
file can be obtained from  one of the anonymous SFTP directories.
  
 File Name                           Contents           Retrieval Format
 ----------------------------        --------           ----------------
 DG_53_P935.KID                      DG*5.3*935         ASCII
                                     IVM*2.0*167
  
 Updated documentation describing the new functionality introduced by this  patch is available.
  
 The preferred method is to retrieve files from download.DNS      .DNS   .
 This transmits the files from the first available server. Sites may  also elect to retrieve files directly from 
a specific server. 
  
 Sites may retrieve the software and/or documentation directly using  Secure File Transfer Protocol 
(SFTP) from the ANONYMOUS.SOFTWARE  directory at the following OI Field Offices:
  
 Hines:              DNS     .URL        
 Salt Lake City:           .URL       
  
 The documentation will be in the form of Adobe Acrobat files.
  
 Documentation can also be found on the VA Software Documentation Library
 at: http://URL            /
  
 Title                               File Name               SFTP Mode
 ----------------------------------------------------------------------
 Release Notes                         IVM_2_0_167_RN.PDF      (binary)
 IVM Technical Manual                  IVM_2_TM_167.PDF        (binary)
 IVM User Manual                       IVM_2_P167_UM.PDF       (binary)
  
 Patch Installation:
  
 Pre/Post Installation Overview:
 -------------------------------
 N/A
  
 Pre-Installation Instructions:
 ------------------------------
 The following kids build DG_53_P935.KID will be installed.
  
 The following option should be disabled during installation of this patch:
       Demographics Upload                   [IVM UPLOAD DEM]
       Patient Inquiry                       [DG PATIENT INQUIRY]
       Load/Edit Patient Data                [DG LOAD PATIENT DATA]
       Register a Patient                    [DG REGISTER PATIENT]
       Preregister a Patient                 [DGPRE PRE-REGISTER OPTION]
       View Registration Data                [DG REGISTRATION VIEW]
       Eligibility Verification              [DG ELIGIBILITY VERIFICATION]
  
 This patch should NOT be installed while the IVM BACKGROUND JOB [IVM  BACKGROUND JOB] is 
running. The HL7 incoming/outgoing filers should be  stopped. Stop All Messaging Background Processes 
by using the [HL STOP ALL]  option on the Filer and Link Management Options [HL MENU FILER LINK 
MGT] menu  on the HL7 Main Menu [HL MAIN MENU].
  
 This patch may be installed with users on the system although it is  recommended that it be installed 
during non-peak hours to minimize  potential disruption to users.  This patch should take less than 5  
minutes to install.
  
 Installation Instructions:
 --------------------------
 1. Download DG_53_P935.KID into your local directory.
  
 2. From the Kernel Installation and Distribution System (KIDS) Menu, 
    select the Installation menu. 
  
 3. Use Load a Distribution option. You may need to prepend a directory 
    name. When prompted for "Enter a Host File: ", respond with
    DG_53_P935.KID
  
     Example: USER$:[ABC]DG_53_P935.KID
  
 4. From the Kernel Installation and Distribution System Menu, select 
    the Installation Menu. From this menu, select the 'Load a Distribution'
    option. When prompted for "Enter a Host File: ", respond with
    DG_53_P935.KID
  
 5.  From the Kernel Installation and Distribution System Menu, select the
     Installation Menu.  From this menu, you may elect to use the following
     options. When prompted for the INSTALL NAME enter the patch # 
     (DG*5.3*935):
     a. Backup a Transport Global - This option will create a backup
        message of any routines exported with this patch. It will not
        backup any other changes such as DD's or templates.
     b. Compare Transport Global to Current System - This option will
        allow you to view all changes that will be made when this    
        (routines, DD's, templates, etc.).
     c. Verify Checksums in Transport Global - This option will allow
        you to ensure the integrity of the routines that are in the
        transport global.
  
 6.  From the Installation Menu, select the Install Package(s) option and
     choose the patch to install. 
  
 7.  When prompted 'Want KIDS to Rebuild Menu Trees Upon Completion of
     Install? NO//', respond NO.
  
 8.  When prompted 'Want KIDS to INHIBIT LOGONs during the install? NO//',
     respond NO.
  
 9.  When prompted 'Want to DISABLE Scheduled Options, Menu Options, and
     Protocols? YES//', respond YES.
  
 10. When prompted 'Enter options you wish to mark as 'Out Of Order':'  
     Enter the following options: 
  
       Demographics Upload                   [IVM UPLOAD DEM]
       Patient Inquiry                       [DG PATIENT INQUIRY]
       Load/Edit Patient Data                [DG LOAD PATIENT DATA]
       Register a Patient                    [DG REGISTER PATIENT]
       Preregister a Patient                 [DGPRE PRE-REGISTER OPTION]
       View Registration Data                [DG REGISTRATION VIEW]
       Eligibility Verification              [DG ELIGIBILITY VERIFICATION]
  
 11. When prompted 'Enter protocols you wish to mark as 'Out Of
     Order':' press <enter>.
  
 12. If prompted 'Delay Install (Minutes):  (0 - 60): 0//', respond 0.
  
 Post-Installation Instructions
 ------------------------------
 The HL7 incoming/outgoing filers should be restarted. Use the  Restart/Start All Links and Filers [HL 
TASK RESTART] option on the Filer  and Link Management Options [HL MENU FILER LINK MGT] menu on 
the HL7 Main  Menu [HL MAIN MENU].  
 
 

Routine Information:
====================
The second line of each of these routines now looks like:
;;2.0;INCOME VERIFICATION MATCH;**[Patch List]**;21-OCT-94;Build 22

The checksums below are new checksums, and  can be checked with CHECK1^XTSUMBLD.

Routine Name: IVMPREC6
    Before:B147873748   After:B155161380  **3,4,12,17,34,58,79,102,115,
                                           140,144,121,151,152,165,167** Routine Name: IVMPREC8
    Before:B230918624   After:B240565370  **5,6,12,58,73,79,102,115,121,
                                           148,151,152,167** Routine Name: IVMPREC9
    Before: B71223010   After: B75404695  **34,58,115,121,151,159,167**
Routine Name: IVMPTRN8
    Before: B78004542   After: B87348227  **9,11,19,12,21,17,24,36,37,
                                           47,48,42,34,77,76,75,79,85,89,
                                           98,56,97,104,113,109,114,105,
                                           115,121,151,141,150,160,161,
                                           167**
 
Routine list of preceding patches: 159, 161, 165

=============================================================================
User Information:
Entered By  : MARRI,NAGARAJA K              Date Entered  : JUL 17, 2017
Completed By:                               Date Completed: 
Released By :                               Date Released : 
=============================================================================


Packman Mail Message:
=====================

No routines included
